## Basic tool info Tool name: RunDiffusion/RunDiffusion XL beta Tool description: A text-to-image model trained on Stable Diffusion XL. Tool cover: https://cdn.wiro.ai/uploads/models/RunDiffusion-RunDiffusion-SDXL_beta-cover.jpg Tool categories: - model - sdxl - text-to-image - checkpoint-file - fp16 - persistent Tool tags: - animals - photorealistic - base model - general use - sdxl Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/RunDiffusion/RunDiffusion XL beta Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: prompt label: prompt help: prompt-help type: textarea default: perfect mix between Carnage from Marvel and Godzilla, with Carnage's red tentacles protruding from his entire body, destroying city, blood, epic, (cataclysmic, white eyes like venom, gargantuan, taller than buildings, oversized, gigantic:1.9), absurdres, best quality, fantasy style - name: negativePrompt label: negativeprompt help: negativeprompt-help type: textarea default: 3d, low quality, worst quality, mutation, deformed hands, ( three arms or more, three hands or more, three legs or more, three feet or more, comics style:1.6) - name: samples label: numberofoutputs help: numberofoutputs-help type: number default: 4 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 20 - name: scale label: guidancescale help: guidancescale-help type: float default: 7.041015625 - name: highNoiseFrac label: high-noise-frac help: high-noise-frac-help type: float default: 0.8 - name: stepsRefiner label: steps-refiner help: steps-refiner-help type: number default: 30 - name: seed label: seed help: seed-help type: text default: 123456 - name: width label: width help: width-help type: number default: 1024 - name: height label: height help: height-help type: number default: 1024 - name: refiner label: refiner help: refiner-help type: select default: options: - value: "--only_base_model" label: NO - value: "" label: YES - name: scheduler label: scheduler help: scheduler-help type: select default: EulerDiscreteScheduler options: - value: "EulerDiscreteScheduler" label: EulerDiscreteScheduler - value: "DDIMScheduler" label: DDIMScheduler - value: "LMSDiscreteScheduler" label: LMSDiscreteScheduler - value: "DPMSolverMultistepScheduler" label: DPMSolverMultistepScheduler - value: "EulerDiscreteScheduler" label: EulerDiscreteScheduler - value: "PNDMScheduler" label: PNDMScheduler - value: "DDPMScheduler" label: DDPMScheduler - value: "EulerAncestralDiscreteScheduler" label: EulerAncestralDiscreteScheduler ## Tool Parameter Inspires: - prompt: perfect mix between Carnage from Marvel and Godzilla, with Carnage's red tentacles protruding from his entire body, destroying city, blood, epic, (cataclysmic, white eyes like venom, gargantuan, taller than buildings, oversized, gigantic:1.9), absurdres, best quality, fantasy style - scale: 7.041015625 - steps: 20 - negativePrompt: 3d, low quality, worst quality, mutation, deformed hands, ( three arms or more, three hands or more, three legs or more, three feet or more, comics style:1.6) - prompt: troll sitting , very detailed face, blue skin, white eyes, moody, epic, shot on Kodak Vision3 - scale: 7.041015625 - steps: 20 - negativePrompt: blur, dof, bokeh, monochrome - prompt: analog film, upper body photo of a beautiful Bolivian woman on the streets of old Bolivian, faded film, desaturated, 35mm photo, vintage, stained, highly detailed, found footage, Holga 120n, film grain, vignette, - scale: 7 - steps: 20 - negativePrompt: asian, cartoon, anime, painting, oil painting, deformed, ugly, bad quality, low quality, nsfw, nude. black and white, bw, b&w, - prompt: analog film, upper body photo of an old man on the streets of old Batavia, faded film, desaturated, 35mm photo, vintage, stained, highly detailed, found footage, Holga 120n, film grain, vignette, - scale: 7 - steps: 20 - negativePrompt: cartoon, anime, painting, oil painting, deformed, ugly, bad quality, low quality, nsfw, nude. black and white, bw, b&w, - prompt: (photographic:1.3), (RAW photo:1.3), (ultra wide lens:1.3), (far shot:1.3), (selfie shot:1.3), (an astronaut bear selfie floating on space:1.3), (helmet on:1.3), (infinite space behind him:1.3), (no gravity:1.1), soft lighting, film grain, Fujifilm XT3, dslr, masterpiece, best quality, realistic, high-quality, realistic works, ultra-high details, 8k uhd, real skin material - scale: 6 - steps: 20 - negativePrompt: (deformed iris, deformed pupils, semi-realistic, cgi, 3d, render, sketch, cartoon, drawing, anime), text, cropped, out of frame, worst quality, low quality, jpeg artifacts, ugly, duplicate, morbid, mutilated, extra fingers, mutated hands, poorly drawn hands, poorly drawn face, mutation, deformed, blurry, dehydrated, bad anatomy, bad proportions, extra limbs, cloned face, disfigured, gross proportions, malformed limbs, missing arms, missing legs, extra arms, extra legs, fused fingers, too many fingers, long neck - prompt: analog film, upper body photo of an old woman on the streets of old Batavia, faded film, desaturated, 35mm photo, vintage, stained, highly detailed, found footage, Holga 120n, film grain, vignette, - scale: 7 - steps: 20 - negativePrompt: cartoon, anime, painting, oil painting, deformed, ugly, bad quality, low quality, nsfw, nude. black and white, bw, b&w, - prompt: beautiful photograph of a white snow owl, big detailed eyes, detailed feathers, snowy background, hdr, national geographic photography, 4k, Ultra-HD - scale: 5 - steps: 25 - negativePrompt: text, watermark, drawing, cartoon - prompt: beautiful photograph of a Siberian tiger, detailed fur, detailed eyes, eastern Russia background, hdr, national geographic photography, 4k, Ultra-HD - scale: 5 - steps: 25 - negativePrompt: drawing, painting, crayon, sketch, graphite, impressionist, cartoon, noisy, blurry, soft, deformed, ugly - prompt: close up photo of a detailed action figure, toy solider with a helmet, photography, tilt blur, Product-View, 4k, Ultra-HD - scale: 7 - steps: 25 - negativePrompt: text, watermark, drawing, cartoon - prompt: (photographic:1.3), (RAW photo:1.3), (ultra wide lens:1.3), (far shot:1.3), (selfie shot:1.3), (an alien taking selfie floating on space:1.3), (infinite space behind him:1.3), (no gravity:1.1), soft lighting, film grain, Fujifilm XT3, dslr, masterpiece, best quality, realistic, high-quality, realistic works, ultra-high details, 8k uhd, real skin material - scale: 6 - steps: 20 - negativePrompt: (deformed iris, deformed pupils, semi-realistic, cgi, 3d, render, sketch, cartoon, drawing, anime), text, cropped, out of frame, worst quality, low quality, jpeg artifacts, ugly, duplicate, morbid, mutilated, extra fingers, mutated hands, poorly drawn hands, poorly drawn face, mutation, deformed, blurry, dehydrated, bad anatomy, bad proportions, extra limbs, cloned face, disfigured, gross proportions, malformed limbs, missing arms, missing legs, extra arms, extra legs, fused fingers, too many fingers, long neck - prompt: castle made of paper, highly detailed, paper clouds, paper trees, paper landscape, Modular Origami, Ultra-HD, Super-Resolution, origami, paper art, high quality image, masterpiece, hdr, 4k, - scale: 9 - steps: 25 - negativePrompt: text, watermark, drawing, cartoon - prompt: close up photo of a cute doll toy with braided hair, photography, tilt blur, Product-View, 4k, Ultra-HD - scale: 5 - steps: 25 - negativePrompt: text, watermark, drawing, cartoon - prompt: cinematic still, filmed by Guillermo del Toro, Amidst a deep dark forest, an enigmatic being appears--an amalgamation of flora and fauna, with vines for hair, eyes gleaming like embers, and skin adorned with iridescent scales - scale: 8 - steps: 50 - negativePrompt: (deformed iris, deformed pupils), text, worst quality, low quality, jpeg artifacts, ugly, duplicate, morbid, mutilated, (extra fingers), (mutated hands), poorly drawn hands, poorly drawn face, mutation, deformed, blurry, dehydrated, bad anatomy, bad proportions, extra limbs, cloned face, disfigured, gross proportions, malformed limbs, missing arms, missing legs, extra arms, extra legs, (fused fingers), (too many fingers), long neck, camera - prompt: (hyperrealism:1.2), masterpiece wide-shot photo of a cozy family room, a sleek, ultra-modern TV adorns a white wall, facing a comfortable couch nestled amidst tastefully selected mid-century modern decor BREAK (8K UHD:1.2), (photorealistic:1.2) - scale: 7 - steps: 25 - negativePrompt: drawing, painting, crayon, sketch, graphite, impressionist, cartoon,noisy, blurry, soft, deformed, ugly - prompt: troll sitting , very detailed face, blue skin, white eyes, moody, epic, shot on Kodak Vision3 - scale: 7.041015625 - steps: 20 - negativePrompt: blur, dof, bokeh, monochrome ## Integration Header Prepare ```bash # Sign up Wiro dashboard and create project export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; export YOUR_API_SECRET="XXXXXXXXX"; # unix time or any random integer value export NONCE=$(date +%s); # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")"; ``` ## Run Command - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Run/RunDiffusion/RunDiffusion XL beta" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "perfect mix between Carnage from Marvel and Godzilla, with Carnage's red tentacles protruding from his entire body, destroying city, blood, epic, (cataclysmic, white eyes like venom, gargantuan, taller than buildings, oversized, gigantic:1.9), absurdres, best quality, fantasy style", "negativePrompt": "3d, low quality, worst quality, mutation, deformed hands, ( three arms or more, three hands or more, three legs or more, three feet or more, comics style:1.6)", "samples": 4, "steps": 20, "scale": "7.041015625", "highNoiseFrac": "0.8", "stepsRefiner": 30, "seed": "123456", "width": 1024, "height": 1024, "refiner": "", "scheduler": "EulerDiscreteScheduler", "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed." }'; ``` ## Run Command - Response ```json { "errors": [], "taskid": "2221", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "result": true } ``` ## Get Task Detail - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "tasktoken": 'eDcCm5yyUfIvMFspTwww49OUfgXkQt', }'; ``` ## Get Task Detail - Response ```json { "total": "1", "errors": [], "tasklist": [ { "id": "2221", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "parameters": {}, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_postprocess_end", "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Task Status Information This section defines the possible task status values returned by the API when polling for task completion. ### Completed Task Statuses (Polling can stop) These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop. - task_postprocess_end : Task completed successfully and post-processing is done. - task_cancel : Task was cancelled by the user or system. ### Running Task Statuses (Continue polling) These statuses indicate that the task is still in progress. Polling should continue if one of these is returned. - task_queue : Task is waiting in the queue. - task_accept : Task has been accepted for processing. - task_assign : Task is being assigned to a worker. - task_preprocess_start : Preprocessing is starting. - task_preprocess_end : Preprocessing is complete. - task_start : Task execution has started. - task_output : Output is being generated.